home *** CD-ROM | disk | FTP | other *** search
/ No Fragments Archive 12: Textmags & Docs / nf_archive_12.iso / MAGS / SOURCES / ATARI_SRC.ZIP / atari source / ST_TT / PREFIX.TXT < prev   
Encoding:
Text File  |  2001-02-10  |  6.0 KB  |  137 lines
  1.  
  2. ---------------------------------------------------------------------
  3. Prefix 1.0
  4. The Header Construction Program
  5. (c) 1990, 1991 -  Atari Corporation
  6. ---------------------------------------------------------------------
  7.  
  8. INTRODUCTION
  9.  
  10. Prefix is a small GEM based program that is designed to assist 
  11. Developers in creating and attaching headers to Control Panel 
  12. Extensions (CPXs). If you aren't familar with Atari's Extensible
  13. Control Panel and it's software interface, please read the 
  14. Developer Specification. It can be downloaded in text format from 
  15. GEnie or can be acquired from Atari's Developer Support Group 
  16. at (408) 745-2568.
  17.  
  18.  
  19. RUNNING PREFIX
  20.  
  21. To use Prefix, run the program from the desktop by double-clicking
  22. on it. Since you are all knowledgeable developers, we will assume 
  23. that you have no problems do this! 
  24.  
  25.  
  26. OK, I AM IN PREFIX, NOW WHAT?
  27.  
  28. Probably the first thing you will want to do is edit a header. To
  29. do this, select the "Edit Header" menu item under the "Header" drop
  30. down menu. 
  31.  
  32. Wow!  A large dialog box appeared! This is the main interface for
  33. editing the contents of your header. You can enter the Title for 
  34. your CPX, the Icon Text, the version number (the default is 01.00),
  35. the CPX ID value, etc. You can also set various flags for the CPX
  36. you are creating. For example, if you would like your CPX to be 
  37. loaded as a RAM resident CPX, you could click on the small box in
  38. front of the words "Ram Resident" under the Flags option. There are
  39. other flags that are available to be turned on or off for your CPX.
  40. These flags are described in detail in the XControl Specification.
  41.  
  42. The last section of the dialog box is the Icon Information section.
  43. This the area in which you can load an Icon or view your CPXs 
  44. Entry in the XControl Panel. When you look at this box, one of the
  45. first things you might notice is the medium sized amount of white 
  46. space located to the left of the "Load Icon" button. This is because
  47. Prefix displays a copy of the icon you have loaded in that space.
  48. You can load an icon by clicking on the "Load Icon" button and 
  49. selecting a filename from the File Selector. Once Prefix has loaded
  50. your icon into memory, it will display it in the space to the left
  51. of the "Load Icon" button.
  52.  
  53. The last button in this area is "View CPX Entry." This button will 
  54. take you to a smaller dialog box that allows you to see just what 
  55. your CPX's entry will look like! Handy, eh? Underneath the sample 
  56. of your CPX's entry, there are sliders to allow you to change the 
  57. Icon and Text Color in your CPX's entry. You can change the default
  58. colors that are displayed in XControl by simply changing these
  59. values. If you decided that you don't want the values you have 
  60. selected, click on the CANCEL button and they will return to whatever
  61. the previous value was (the default colors are 1 and 1). The CPX 
  62. Entry dialog is also accessible from the "Header" drop-down menu 
  63. by clicking on the menu item "View CPX Entry." If you have accessed
  64. the View CPX Dialog from the Edit Header menu option, clicking CANCEL
  65. or OK in the View CPX Entry Dialog will return you to the Edit 
  66. Header Dialog Box.
  67.  
  68. Last but not least, clicking CANCEL in the Edit Header Dialog Box 
  69. will cancel _any_ changes you made in the Header at all. This 
  70. includes and color changes you have made in the View CPX Entry!
  71. Be careful..
  72.  
  73. THE FILE MENU
  74.  
  75. The "File" drop-down menu is pretty simple. It is broken down 
  76. into four sections:
  77.  
  78.  -    "Load .HDR" and "Save .HDR" are the two options that handle
  79.     the loading and saving of Header files. the .HDR extension
  80.      is used to designate a Header file. After selecting either 
  81.     or these menu items, you will be presented with a File 
  82.     Selector. Just select the file you wish to use.
  83.  
  84.  -    "Load from .CPX" and "Save to .CPX" allow you to use the 
  85.     Headers that already been attached to a CPX file. Both 
  86.     options work in the same manner as "Load .HDR" and "Save
  87.     .HDR" described above.
  88.  
  89.  -    "Attach to .CP" will probably be your most used menu item
  90.     here. This is the guts of Prefix: Attaching a .HDR file to
  91.     a .CP (NOTE: a .CP file is a CPX file that does not have 
  92.     a header attached. When you compile your CPX with your 
  93.     compiler, you would create a .CP file, then use Prefix to
  94.     create a header and attach it to create the CPX file). It
  95.     will first ask you to select the name of the Header File,
  96.     then the name of the .CP file, and finally the name of 
  97.     the final CPX. All input is done from a standard File
  98.     Selector.
  99.  
  100.  -    "Quit" is self-documenting. It allows you to exit the program.
  101.     One small note, the program will ask you if you would like
  102.     to Quit if you have made any changes. 
  103.  
  104. That describes all of the options available in the "File" menu.
  105. One last thing to note: if you select a filename that already
  106. exists on a "write-to-disk" option, Prefix will ask you if you
  107. would like to overwrite the file via an Alert Box. Click on 
  108. Yes or No depending on what you want to do. This may come in 
  109. handy if you mess up and select the wrong file.
  110.  
  111. FINAL NOTES
  112.  
  113. Some of you may have noticed that there is no provision to edit
  114. the magic number in the header. This is done on purpose. This 
  115. number is the equivalent of a "header version number" for the
  116. Control Panel. If we decide to make changes to the Header format,
  117. we can change this number to let the Control Panel know it is
  118. handling a new header type. 
  119.  
  120. Last but not least, this is version 1.0 of this program. I am 
  121. planning to add default directories, installed application 
  122. features, command lines, etc. to this program in the near future.
  123. If you have suggestions for Prefix, I would like to hear them.
  124. This program is not intended to be a solution to all and I am 
  125. sure that there are people out there who will write their own 
  126. Prefix type programs. But, if you have a suggestion or know of 
  127. a way that Prefix could be improved, please feel free to drop me
  128. a line and let me know!
  129.  
  130. -- John Townsend
  131.    Atari Corporation
  132.    GEnie:     TOWNS
  133.    USEnet:    towns@atari.uucp
  134.  
  135.  
  136.  
  137.